home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 033a / apup222.zip / ACTVIEW.DOC < prev    next >
Text File  |  1992-01-03  |  14KB  |  310 lines
  1.  ---------------------------------------------------------------------------
  2.                              ACTVIEW PCB 2.22 (c)
  3.                      PCBoard Activity Log Viewer/Analyzer
  4.                        Copyright (c) 1992 by Greg Wilson
  5.                              All Rights Reserved
  6.                                    01/03/92
  7.                              Author: Greg Wilson
  8.  ---------------------------------------------------------------------------
  9.  
  10.                                    Purpose
  11.                                    -------
  12.  Actview was written out of my own need for a tool to assist with reading the
  13.  activity log of my BBS. The task of viewing the log with a file viewer was
  14.  taking too long and I found myself rushing through the process, missing many
  15.  important events such as invalid password attempts, carrier drops, new users,
  16.  etc..
  17.  
  18.  Actview was originally written for Wildcat BBS's but after the fantastic
  19.  response I received from Sysops, I decided to write a version for PCBoard as
  20.  well!
  21.  
  22.                                  Instructions
  23.                                  ------------
  24.  For a quick look at what Actview has to offer, copy ACTVIEW.EXE to the
  25.  directory containing your CALLER file(s) and run it. If you have more than
  26.  one node or use a different naming convention, you will have to build a file
  27.  named ACTVIEW.CFG (see below). The program will display the last recorded
  28.  day's activity in a one line per call format with the critical information
  29.  shown. At the top of the screen, the range of dates in the log is displayed
  30.  along with the date of the information being displayed. The primary Fkey
  31.  functions are displayed at the bottom of the screen. More functions are shown
  32.  in the help window (F1). The calls can be scrolled using the arrows, home,
  33.  end, page up, and page down keys. If enter is pressed, the detail of the
  34.  highlighted call is extracted from the activity log and displayed. Important
  35.  events such as invalid logon attempts, file overwrites, etc., are
  36.  highlighted.
  37.  
  38.  
  39.  Key     Function
  40.  ------------------------------------------------------------------------
  41.  F1    - Displays the help window.
  42.  F2    - Swaps to another node's log. Directories to your different logs must
  43.          be entered in a file named ACTVIEW.CFG (see below).
  44.  F3    - Displays the following activity:
  45.          * Invalid logon attempts.
  46.          * Invalid Passwords.
  47.          * BBS errors
  48.          To return to the normal display, hit escape.
  49.  F4    - Displays totals for the currently displayed date.
  50.  F5    - Displays new users for the displayed day.
  51.          To return to the normal display, hit escape.
  52.  F6    - Allows jumping directly to any date in the activity log.
  53.  F7    - Jumps to the previous day's activity.
  54.  F8    - Jumps to the next day's activity.
  55.  
  56.  F9    - Displays all calls of a specified user. The program will prompt for
  57.          user name, beginning date, and ending date of search. The name will
  58.          default to the highlighted call. The dates will default to the
  59.          beginning and end of the activity log. Actview will scan the log
  60.          finding all matching calls and then display the calls in the usual
  61.          one line per call format. To view totals for the user, hit F4. To
  62.          return to the normal display, hit Escape. To abort the search, press
  63.          the space bar.
  64.  F10/ ALT-X / ESC - Quit Actview.
  65.  ALT-L - Toggles local calls. Local calls will not be displayed or
  66.          included in the daily counts.
  67.  ALT-S - Allows the entire activity log to be searched for a given string
  68.          (such as filename, Message#, ..etc.). Here are some ways I use this
  69.          feature:
  70.          * Search for all activity related to a particular file.
  71.          * Search for all activity related to a bulletin or door.
  72.          * Find all users that still use XMODEM.
  73.          * See who is using QMAIL.
  74.          * See who has exceeded their time limit.
  75.          * ...etc.!
  76.  ALT-D - View all downloads for the day.
  77.  ALT-U - View all uploads for the day.
  78.  ALT-O - Sort calls. Actview will display a menu of 7 different sort types.
  79.  ALT-V - View all activity logs for all nodes. Every log in the ACTVIEW.CFG
  80.          file is scaned for the currently displayed date and the calls are
  81.          loaded. This is a major time saver!
  82.  
  83.  
  84.  
  85.  A typical Actview session would go something like:
  86.  
  87.       * Type ACTVIEW (if multinode, use parameter VIRTUAL to load all nodes)
  88.       * Hit F3; if any errors are displayed, view the detail.
  89.       * Hit F5; view new users.
  90.       * Hit ALT-U to see what was uploaded.
  91.       * Hit ALT-D to see what was downloaded.
  92.       * Hit ESC to go back to viewing all calls.
  93.       * Scroll though the summary looking for uploads, msgs, carrier
  94.         drops and pages viewing the detail of these activities if desired.
  95.  
  96.  An average review takes me about 3 minutes compared to 30 minutes before
  97.  I had ACTVIEW!
  98.  
  99.                               User Defined Flags
  100.                               ------------------
  101.  
  102.  Actview allows sysops to define flags to indicate that a certain activity has
  103.  occured during a call. These one character flags are displayed on the initial
  104.  call summary screen and are defined in the file ACTVIEW.FLG. This has many
  105.  uses including:
  106.  
  107.                 * Flag all users that download a certain file
  108.                 * Flag all users that use a certain door
  109.                 * Flag all users that drop carrier
  110.                 * Flag all users that join a certain conference
  111.                 * .. etc.
  112.  
  113.  A flag is a single character to be displayed in the flag column on the
  114.  summary screen. Up to 5 flags can be displayed for a single call. If more
  115.  than 5 flags are found, the last flag will be then character "*". In the
  116.  ACTVIEW.FLG file, the first column contains the flag character to be
  117.  displayed. The string to turn on the flag is enclosed in quotes on the same
  118.  line as the flag character.
  119.  
  120.  Example: If an additional flag was desired to show any activity related to
  121.  the file "ACTVIEW.ZIP", ACTVIEW.FLG would be updated as follows (remember
  122.  that the flag characters must be in column 1):
  123.  
  124.                               C "CARRIER LOST"
  125.                               C "LINK LOST"
  126.                               N "NEW EXTUSER"
  127.                               A "ACCESS DENIED"
  128.                               P "PASSWORD FAILURE"
  129.                               S "ATTEMPTED TO LOGON AS"
  130.                               V "ACTVIEW.ZIP"
  131.  
  132.                      ***    Note: Case is ignored    ***
  133.  
  134.  See the file ACTVIEW.FLG for more examples. The initial flags for dropping
  135.  carrier, errors, new users, and exceeding download ratio are already set up.
  136.  
  137.  
  138.                              Multi Node Features
  139.                              -------------------
  140.  
  141.  For multi-node operation, create a file named ACTVIEW.CFG with the
  142.  directories and filenames in the following format: (in column 1)
  143.  
  144.                        C:\PCB\CALLER1
  145.                        C:\PCB\CALLER2
  146.                        C:\PCB\CALLER3
  147.                        C:\PCB\CALLER4
  148.  
  149.  The entire path *and* filename must be specified in each line.
  150.  
  151.  NOTE: ACTVIEW.CFG must be in the same directory as ACTVIEW.EXE
  152.  
  153.  This feature may also be useful for single node sysops that maintain backup
  154.  copies of their logs under other names and/or directories and still want to
  155.  access them via Actview.
  156.  
  157.  
  158.  
  159.                               Actview parameters
  160.                               ------------------
  161.  
  162.           ACTVIEW mm/dd/yy NOLocal ERRors NEW NODE=x MONO SNOW BIOS
  163.  
  164.             mm/dd/yy - Go directly to mm/dd/yy
  165.             HELP     - Display help screen
  166.             NOLocal  - Do not show local calls (ALT-L toggles)
  167.             ERRors   - Show logon errors for the day (F3 toggles)
  168.             NEW      - Show new users only (F5 toggles)
  169.             NODE=x   - Go to node x. ACTVIEW.CFG must be present.
  170.             MONO     - Force monochrome attributes
  171.             NOMOUSE  - Turn Off Mouse support (speeds up entry and exit).
  172.             SNOW     - Turn on snow checking during screen writes
  173.             VIRT     - View all nodes at once.
  174.             BIOS     - Use bios screen writes. This option is not necessary
  175.                        when running Actview under Desqview because checks for
  176.                        Desqview are made and direct screen writes are remapped
  177.                        accordingly. BIOS writes are much slower than the
  178.                        normal direct screen writes and should not be used.
  179.             LARGE    - Use large jump values during searches. This parameter
  180.                        is normally not needed unless some of the calls in the
  181.                        activity logs exceed 100 lines (usually netmail hubs).
  182.                        If Actview sometimes hangs, try this parameter. It is
  183.                        not the size of the actual activity log file but the
  184.                        size of the individual calls within the log.
  185.  
  186.  
  187.                            Requirements and Limits
  188.                            -----------------------
  189.  * ACTVIEW is Desqview aware. No extra parameters are needed for Desqview as
  190.    Actview detects DV automatically.
  191.  
  192.  
  193.                       Memory requirements: 220k (Multi node see note)
  194.                  Max nodes in ACTVIEW.CFG: 100
  195.                                 Max flags: 100
  196.  
  197.   Max number of displayed calls is now only limited by the available memory.
  198.   The max number is displayed in the help window. This is also the max number
  199.   of hits when searching (ALT-S or F9). If the search finds more than the
  200.   available number of displayed calls, a message will be displayed and the
  201.   search will be halted.
  202.  
  203.   Multi-node note: If your BBS receives a lot of calls each day, more memory
  204.   will be needed to view the calls. With 200k, only about 400 calls per day
  205.   are allowed to be viewed at once. The max number of calls is displayed in
  206.   the help window.
  207.  
  208.  * Actview opens the CALLER files in shared READ ONLY mode. *No* writes are
  209.    made to any files.
  210.  
  211.  
  212.                                   Liability
  213.                                   ---------
  214.  
  215.  Actview has been tested on multiple machines using many different
  216.  configurations and no problems have occured. However, if a problem does
  217.  arise due to Actview, I cannot be held responsible. Use at your own risk.
  218.  
  219.  
  220.                         Distribution and Registration
  221.                         -----------------------------
  222.  
  223.  Actview may be freely distributed only as the following unaltered files:
  224.  
  225.                                  ACTVIEW.EXE
  226.                                  ACTVIEW.FLG
  227.                                  ACTVIEW.DOC
  228.                                  ACTVIEW.HIS
  229.                                  READ.ME
  230.                                  DESC.SDI
  231.                                  REGISTER.DOC
  232.  
  233.  ACTVIEW is  not free. You must register after the 30-day evaluation time
  234.  period.
  235.  
  236.  ACTVIEW is a Shareware product.  It is distributed through public access
  237.  channels so that perspective buyers can have the opportunity to evaluate the
  238.  product before making a  decision to buy. If you decide to use this software,
  239.  then you are under both legal and moral obligation to register it with the
  240.  author. But if you decide not to use it after evaluating the software, you
  241.  are under no obligation. It is fully protected by State, Federal and
  242.  International copyright laws.
  243.  
  244.  If you continue to use ACTVIEW after the 30-day evaluation time period you
  245.  must register it.
  246.  
  247.                             Registration Fee  : $25 US
  248.  
  249.  Why Register?
  250.  --------------------------------------------------------------------
  251.  * All opening and closing screens are removed!
  252.  * Registered users have access to the Actview support BBS is granted!
  253.  * All Actview reports can be downloaded from the support BBS!
  254.  * All future updates are free!
  255.  
  256.  
  257.  To register your copy of ACTVIEW, complete in the order form (REGISTER.DOC)
  258.  and mail along with your check or money order payable to "Greg Wilson" to:
  259.  
  260.                           Greg Wilson
  261.                           1427 Valley Lake Dr. #1228
  262.                           Schaumburg, Il 60195
  263.  
  264.  ██████████████████████████████████████████████████████████████████████████████
  265.                 * Credit Card Orders (VISA/MC/Discover/Amex) *
  266.  ██████████████████████████████████████████████████████████████████████████████
  267.  
  268.          Visa/MC/Amex/Discover (via the Public Software Library):
  269.  
  270.                         1-800-2424-PSL or 713-524-6394
  271.                         FAX: 1-713-524-6398
  272.                         CIS Email: 71355,470
  273.  
  274.                               Product #10408
  275.  
  276.                     Credit card Price is $15 + $3 handling
  277.  
  278.                       THESE NUMBERS ARE FOR ORDERS ONLY!
  279.  
  280.                Do not call these numbers for technical support!
  281.  
  282.       All orders are relayed back to me the same day the order is made.
  283.  
  284.     The registered version can be shipped, uploaded or downloaded from my
  285.                             BBS or via CompuServe.
  286.  
  287.  ██████████████████████████████████████████████████████████████████████████████
  288.  
  289.  
  290.  
  291.  
  292.                             Contacting the Author
  293.                             ---------------------
  294.  
  295.  I can be reached for comments, questions, suggestions, complaints, etc., at
  296.  the following EMAIL boxes:
  297.  
  298.  
  299.            My BBS            (SYSOP)            - mail checked daily
  300.            Salt Air          (GREG WILSON)      - Main Conference Only Daily
  301.            CompuServe        (76547,3106)       - mail checked daily
  302.            EXEC-PC           (GREGORY WILSON)   - mail checked daily
  303.            Channel 1         (GREG WILSON)      - mail checked daily
  304.            PC-Ohio           (GREG WILSON)      - mail checked daily
  305.            Executive Network (GREG WILSON)      - mail checked daily
  306.  
  307.  
  308.  
  309.                                     -end-
  310.